README.md

docker-ghidra-server

Ghidra Server Docker Image

Why?

Standing up a Ghidra Server in the cloud is a pain. It doesn't have to be. If you're new to Ghidra Server, this primer is a good introduction.

Images

bytehow/ghidra-server   latest
bytehow/ghidra-server   11.0.3
bytehow/ghidra-server   10.3
bytehow/ghidra-server   10.2.2
bytehow/ghidra-server   10.1.5
bytehow/ghidra-server   9.2      
bytehow/ghidra-server   9.1.2    

If you'd like to use the latest from Ghidra's master branch, build an image using Dockerfile.beta.

Getting Started

Start the server and connect to port 13100 with a Ghidra client that has a matching version. All users will be created as admins and will have initial password changeme, which Ghidra will require you to change after you login.

Public Server

docker run -it --rm \
    --name ghidra-server \
    -e GHIDRA_USERS="admin bytehow" \
    -v /path/to/repos:/repos \
    -p 13100-13102:13100-13102 \
    bytehow/ghidra-server

Local-only Server

docker run -it --rm \
    --name ghidra-server \
    -e GHIDRA_USERS="admin bytehow" \
    -e GHIDRA_PUBLIC_HOSTNAME="0.0.0.0" \
    -v /path/to/repos:/repos \
    -p 13100-13102:13100-13102 \
    bytehow/ghidra-server

Environment Variables

Name	Description	Required	Default
GHIDRA_USERS	Space seperated list of users to create	No	admin
GHIDRA_PUBLIC_HOSTNAME	IP or hostname that remote users will use to connect to server. Set to 0.0.0.0 if hosting locally. If not set, it will try to discover your public ip by querying OpenDNS	No	Your public IP

Additional information

Additional information such as capacity planning and other server configuration aspects can be found by consulting the server documentation provided at /<GhidraInstallDir>/server/svrREADME.html

Issues

Find a bug? Want more features? Find something missing in the documentation? Let me know! Please don't hesitate to file an issue

Credits

• NSA Research Directorate https://www.ghidra-sre.org/
• blacktop's docker-ghidra project

License

Apache License (Version 2.0)