Page MenuHomePhorge
Files F2890654

readme.md
No OneTemporary
Actions

readme.md
View Options

A docker-compose configuration for running a phabricator server for development
## One-time Setup
1. Clone this repository
2. Modify the `.env` file to set desired variables
- The `INSTALLDIR` variable should generally not be changed, it's the location within the container where phabricator/arcanist will be installed to.
- The `HOST` variable is the hostname for phabricator to be hosted on. Phabricator requires something with a `.` so this cannot be `localhost`. Pro-tip: do not use `something.dev` as the `.dev` TLD is a valid domain and browsers will likely force loading using HTTPS instead of HTTP.
- The `PORT` variable is the port to be exposed on the host, in case other services are running or you don't want to use the default port 80.
3. Modify the `conf/local.json` file to configure for your setup
- Items above the blank line should generally not need configured. JSON does not support comments otherwise this would be indicated directly in the file.
- Update `phabricator.timezone` to match your current/local timezone. The value for this should be a valid PHP time zone.
3. Clone phabricator and arcanist repos within this one (the `.gitignore` will avoid git repo conflicts).
```
$ git clone ../phabricator.git
$ git clone ../arcanist.git
```
Alternative, symlink `phabricator` and `arcanist` inside the repo folder
```
$ ln -s ../phabricator phabricator
$ ln -s ../arcanist arcanist
```
4. Start the containers. The first time this runs the container image will be built.
```
$ docker-compose up
```
5. Modify local `/etc/hosts` or `C:\Windows\System32\drivers\etc\hosts` and add `127.0.0.1 phabricator.test`
6. Navigate to `http://phabricator.test`
7. Address outstanding setup issues such as configuring an Auth Provider
- These setup issues can be ignored since this is only intended for local development:
- Alternate File Domain Not Configured
- Mailers Not Configured
8. You will probably want to register a new account while remaining logged in as the initial admin. The initial admin account does not have a password. The only way to set a password for this admin account requires sending email, which this development environment does not have configured.
- Pro tip: You can lower the minimum password length by changing `account.minimum-password-length` setting.
## Shutting down, restarting
When running with `docker-compose up` the stdin/stdout will be tied to your terminal. If you want to run it in the background use `docker-compose up -d`.
To stop the services use `docker-compose stop`.
If you need to modify the `.env` file after the first time running `docker-compose up` you will need to re-build using `docker-compose build --no-cache`.

File Metadata

Mime Type
text/plain
Expires
Sun, Jan 19, 13:54 (3 w, 2 d ago)
Storage Engine
blob
Storage Format
Raw Data
Storage Handle
1124827
Default Alt Text
readme.md (2 KB)

Event Timeline

Content licensed under Creative Commons Attribution-ShareAlike 4.0 (CC-BY-SA) unless otherwise noted; code licensed under Apache 2.0 or other open source licenses. · CC BY-SA 4.0 · Apache 2.0