gitea/docker/README.md

65 lines
1.5 KiB
Markdown
Raw Normal View History

2015-08-17 13:38:49 +02:00
# Docker for Gogs
2015-08-18 16:29:02 +02:00
Visit [Docker Hub](https://hub.docker.com/r/gogs/gogs/) see all available tags.
## Usage
2015-08-17 13:38:49 +02:00
2015-08-18 16:29:02 +02:00
To keep your data out of Docker container, we do a volume(`/var/gogs` -> `/data`) here, and you can change it based on your situation.
```
2015-08-18 16:29:02 +02:00
# Pull image from Docker Hub.
$ docker pull gogs/gogs
# Create local directory for volume.
$ mkdir -p /var/gogs
2015-08-18 16:29:02 +02:00
# Use `docker run` for the first time.
$ docker run --name=gogs -p 10022:22 -p 10080:3000 -v /var/gogs:/data gogs/gogs
# Use `docker start` if you have stopped it.
$ docker start gogs
```
2015-08-18 16:29:02 +02:00
Files will be store in local path `/var/gogs` in my case.
2015-08-17 13:38:49 +02:00
Directory `/var/gogs` keeps Git repoistories and Gogs data:
/var/gogs
2015-08-17 09:17:18 +02:00
|-- git
2015-08-18 16:29:02 +02:00
| |-- gogs-repositories
|-- ssh
2015-08-18 16:29:02 +02:00
| |-- # ssh public/private keys for Gogs
|-- gogs
2015-08-17 09:17:18 +02:00
|-- conf
|-- data
|-- log
2015-08-18 16:29:02 +02:00
|-- templates
2015-08-17 09:17:18 +02:00
## SSH Support
2015-08-18 16:29:02 +02:00
In order to support SSH, You need to change `SSH_PORT` in `/var/gogs/gogs/conf/app.ini`:
2015-08-17 09:17:18 +02:00
```
[server]
SSH_PORT = 10022
```
2015-08-17 13:38:49 +02:00
Full documentation of settings can be found [here](http://gogs.io/docs/advanced/configuration_cheat_sheet.html).
2015-08-17 15:12:47 +02:00
## Todo
2015-08-18 16:29:02 +02:00
Install page need support set `SSH_PORT`.
## Troubleshooting
2015-08-17 15:12:47 +02:00
2015-08-18 16:29:02 +02:00
If you see the following error:
2015-08-17 15:12:47 +02:00
```
checkVersion()] [E] Binary and template file version does not match
```
2015-08-18 18:34:11 +02:00
Run `rm -fr /var/gogs/gogs/templates/` should fix this it. Just remember to backup templates file if you have made modifications youself.
## Known Issues
- [Use ctrl+c when clone through SSH makes Docker exit unexpectedly](https://github.com/gogits/gogs/issues/1499)