|
|
||
|---|---|---|
| .devcontainer | ||
| .forgejo/workflows | ||
| .githooks | ||
| .vscode | ||
| backend | ||
| backend-legacy | ||
| routes/Hermes API | ||
| sshfrontend | ||
| .gitconfig | ||
| .gitignore | ||
| .prettierrc | ||
| CHANGELOG.md | ||
| dev-docker-compose.yml | ||
| docker-compose.yml | ||
| init.sh | ||
| LICENSE | ||
| prod-docker.env | ||
| README.md | ||
| shell.nix | ||
Hermes
Port forwarding across boundaries.
Local Development
Note
Using Nix is recommended for the development environment. If you're not using it, install Go and NodeJS. Using Docker is required for database configuration.
-
First, make sure you have a sane copy of Docker installed, and make sure the copy of Docker works.
-
Secondly, check if you have a working Nix environment if you're using Nix.
-
Lastly, Run
nix-shell, or alternativelysource init.shif you're not using Nix.
API Development
-
After that, run the project in development mode:
npm run dev. -
If you want to explore your database, run
npx prisma studioto open the database editor.
Production Deployment
Warning
Deploying using Docker Compose is the only officially supported deployment method.
- Copy and change the default password (or username & db name too) from the template file
prod-docker.env:
sed "s/POSTGRES_PASSWORD=nextnet/POSTGRES_PASSWORD=$(head -c 500 /dev/random | sha512sum | cut -d " " -f 1)/g" prod-docker.env > .env
- Build the docker stack:
docker compose --env-file .env up -d
Troubleshooting
-
I'm using SSH tunneling, and I can't reach any of the tunnels publicly.
- Be sure to enable GatewayPorts in your sshd config (in
/etc/ssh/sshd_configon most systems). Also, be sure to check your firewall rules on your system and your network.
- Be sure to enable GatewayPorts in your sshd config (in