πΊ Yes. We have to drink. But we also have to pay. This is the drinking part.
To provide a consistent experience on every system, docker and docker-compose is used during development and production.
- Install Docker and Docker Compose (if not already included).
- Start the development server
make up
This will start a development server on http://localhost:3000. Cancelling this command will leave tap running in the background. You can stop it using
make down. - Seed the database.
make seed
The development setup uses a SQLite 3 database, which can be found under
/db/development.sqlite3.
See the Makefile for all commands.
- Install WSL (Windows Subsystem for Linux)
- Follow the instructions for Linux/Unix above
Tip
If you have nix with flakes, run nix develop.
- Install gems:
bundle install - Install npm packages:
npm i - Initialize and migrate the db:
bundle exec rails db:migrate - Seed the db:
bundle exec rails db:seed - Start Tap:
./bin/dev(or runnpm run build:js, thenbundle exec rails s)
Run bundle exec rake
or if that doesn't work try bundle exec rspec?
- Run
bundle exec rubocopto lint - To autocorrect most offences
- safely :
bundle exec rubocop -a - unsafely :
bundle exec rubocop -A
- safely :
- Make sure your user has access to tap@tap.zeus.gent.
- Uncomment the
- "${HOME}/.ssh:/root/.ssh:ro"line indocker-compose.yml. - Run
make deploy.
Can I use Tap for development without setting up Tab?
Tap does not sync with Tab when in development mode. The user's balance is mocked by Ζ΅12.34 instead.How do I login as the "Koelkast" user?
In development, you can login as Koelkast using the link: http://localhost:3000/sign_in?token=tokenI get a "mismatching_redirect_uri" error when trying to login
The Zeus authentication provider has a pre-configured list of hosts that are allowed to use the login. http://localhost:3000 is on this list and should be used for development.Docker image build is stuck on "Fetching gems..." or another command
If you are connected to the **`eduroam`** network, Docker build will not have access to the internet. This is because eduroam and docker use the same IP range, which causes conflicts. To solve this you can [reconfigure Docker to use a different IP range](https://support.skyformation.com/hc/en-us/articles/360009195759-How-To-Change-the-Docker-IP-address-space). A recommended range can be `172.31.248.0/21` which is rarely used by other networks.There are no transactions going from Tap to Tab
The delay job may not be running. You can start it using:sudo -u tap RAILS_ENV=production /home/tap/production/current/bin/delayed_job start
This software is distributed under the terms of the MIT. A copy of this license can be found in the LICENSE file.
Copyright Β© 2014-2025 Zeus WPI bestuur@zeus.gent