Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cedws/docker-ghidraserver
Containerised Ghidra server
https://github.com/cedws/docker-ghidraserver
docker docker-compose ghidra
Last synced: 2 months ago
JSON representation
Containerised Ghidra server
- Host: GitHub
- URL: https://github.com/cedws/docker-ghidraserver
- Owner: cedws
- License: gpl-3.0
- Created: 2021-11-13T20:28:49.000Z (about 3 years ago)
- Default Branch: master
- Last Pushed: 2024-11-11T21:23:57.000Z (2 months ago)
- Last Synced: 2024-11-11T22:18:23.251Z (2 months ago)
- Topics: docker, docker-compose, ghidra
- Language: Shell
- Homepage:
- Size: 39.1 KB
- Stars: 7
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# docker-ghidraserver
This project attempts to containerise Ghidra server in a way that isn't a complete pain in the ass. Unfortunately Ghidra is a pretty legacy "masterpiece" and is extremely hostile to containerisation and even basic DevOps practices. Abandon all ye who enter here.
## Running
To start adding users, you need to start up the server at least once to initialise the `repositories` directory. This contains all of the server's state including projects and users, so you don't need to create mounts or volumes for anything else.
If you want to use Docker Compose, modify `docker-compose.yml` to your liking and follow the steps for Compose.
For some dumb reason, Ghidra needs to know what FQDN you'll be using to connect to it. Set `GHIDRASERVER_FQDN` to the external IP address or domain name you're connecting to it with on the clientside.
With Compose:
```sh
docker-compose up -d
```
With bare Docker:
```sh
docker run -e GHIDRASERVER_FQDN=YOUR_SERVER_FQDN -p 13100-13102:13100-13102 -v "$PWD/repositories:/srv/repositories" -d --name ghidraserver ghcr.io/cedws/docker-ghidraserver:latest
```
## Adding users
With Compose:
```sh
docker-compose exec server /entrypoint.sh "./svrAdmin -add myuser --p"
```
With bare Docker:
```sh
docker exec -it ghidraserver /entrypoint.sh "./svrAdmin -add myuser --p"
```
## Removing users
With Compose:
```sh
docker-compose exec server /entrypoint.sh "./svrAdmin -remove myuser"
```
With bare Docker:
```sh
docker exec -it ghidraserver /entrypoint.sh "./svrAdmin -remove myuser"
```
## Contribution
This repository uses [updatecli](https://www.updatecli.io/) to update the reference to the latest Ghidra release artifact.