30 lines
1.5 KiB
Markdown
30 lines
1.5 KiB
Markdown
# Firefish Developer Docs
|
|
|
|
## Containerized Environment
|
|
|
|
The Firefish repo comes with a new containerized environment to help make development!
|
|
|
|
### Prerequisites
|
|
|
|
- Latest [Docker](https://docs.docker.com/get-docker/) installation
|
|
- Alternatively, you can use [Podman](https://podman.io/docs/installation) and [Podman Compose](https://github.com/containers/podman-compose).
|
|
- The following ports are not in use
|
|
- 3000
|
|
- 25432
|
|
- 26379
|
|
|
|
### Start up the environment
|
|
|
|
1. Run `git clone https://firefish.dev/firefish/firefish.git && cd firefish` to fetch needed files.
|
|
- If you don't want to clone the entire repository, you can just download the [`dev` directory](https://firefish.dev/firefish/firefish/-/tree/develop/dev) and execute `chmod +x dev/docker-entrypoint.sh`.
|
|
1. Open `dev/docker-compose.yml` and set `FIREFISH_URL` to the URL you want to use (or leave it to `http://localhost:3000`).
|
|
1. Run `docker compose --file dev/docker-compose.yml up`. This will build the environment, dependencies and prepare the needed config files.
|
|
- If you use Podman, you should run `podman-compose --file dev/docker-compose.yml up` instead.
|
|
1. Wait until the following message shows up.
|
|
```
|
|
DONE * [core boot] All workers started
|
|
DONE * [core boot] Now listening on port 3000 on https://your_firefish_url.example.com
|
|
```
|
|
1. A fresh Firefish environment is created on the URL you have set!
|
|
|
|
When you want to restart the dev server, you just need to terminate the process (a.k.a. press `Ctrl+C`) and run `docker compose up` again.
|