{"id":18733928,"url":"https://github.com/mgoltzsche/liteide-docker","last_synced_at":"2025-04-12T18:32:00.618Z","repository":{"id":53819136,"uuid":"186711384","full_name":"mgoltzsche/liteide-docker","owner":"mgoltzsche","description":"LiteIDE containerized: A fast reproducible Go development environment","archived":false,"fork":false,"pushed_at":"2025-04-02T21:10:30.000Z","size":57,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-02T22:22:50.892Z","etag":null,"topics":["container","container-image","containerized","docker","go","golang","ide","liteide"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mgoltzsche.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2019-05-14T22:47:08.000Z","updated_at":"2025-04-02T21:10:33.000Z","dependencies_parsed_at":"2024-11-07T15:11:53.675Z","dependency_job_id":"065e638d-c5ca-496c-bed4-cc3206dee99b","html_url":"https://github.com/mgoltzsche/liteide-docker","commit_stats":null,"previous_names":[],"tags_count":22,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgoltzsche%2Fliteide-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgoltzsche%2Fliteide-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgoltzsche%2Fliteide-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mgoltzsche%2Fliteide-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mgoltzsche","download_url":"https://codeload.github.com/mgoltzsche/liteide-docker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248613596,"owners_count":21133546,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["container","container-image","containerized","docker","go","golang","ide","liteide"],"created_at":"2024-11-07T15:11:49.025Z","updated_at":"2025-04-12T18:32:00.364Z","avatar_url":"https://github.com/mgoltzsche.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LiteIDE Docker image\n\nA [LiteIDE](https://github.com/visualfc/liteide) redistribution as\n[Docker](https://www.docker.com) container image providing a fast,\nportable, reproducible [Go](https://golang.org/) development\nenvironment.\n\n\n## Usage\n\nThis image can be run using the launcher script `liteide.sh` or using\nDocker directly.\n\n### Install the launcher script\n\nInstall the launcher script on your host:\n```\ncurl -fsSL https://raw.githubusercontent.com/mgoltzsche/liteide-docker/master/liteide.sh -o /tmp/run-liteide \u0026\u0026\nchmod +x /tmp/run-liteide \u0026\u0026\nsudo mv /tmp/run-liteide /usr/local/bin/run-liteide\n```\n\n### Launcher script usage\n\nThe launcher can be used as follows:\n```\nrun-liteide PROJECTDIR [PACKAGE]\n```\n\n| Argument     | Description |\n| ------------ | ----------- |\n| `PROJECTDIR` | The project directory that should be opened with LiteIDE |\n| `PACKAGE`    | Optional: the package your `PROJECTDIR` should be mounted to |\n\n| Environment variable | Description |\n| -------------------- | ----------- |\n| `LITEIDE_INI`     | Path to a `liteide.ini` file that should be used. Default: `$PROJECTDIR/liteide.ini` |\n| `LITEIDE_VERSION` | LiteIDE version |\n| `LITEIDE_IMAGE`   | full LiteIDE Docker image name (overwrites `LITEIDE_VERSION`) |\n| `LITEIDE_CACHE`   | if set to `on` the directory `.liteide-cache` is mounted to the container's `GOPATH` |\n\n\n### Using Docker directly (optional)\n\nIn order to run a container using this image directly you need to\nprovide several options:\n\n- provide your host UID/GID as `CHOWN` environment variable in order to run LiteIDE as your user (not required when using [podman](https://podman.io/))\n- pass through your host's `DISPLAY` environment variable\n- mount your host's `/etc/machine-id`\n- mount your project directory into the container's `/go` directory (`GOPATH` points to `/go`)\n- optionally you can also mount your project's `liteide.ini` to `/tmp/liteide/.config/liteide/liteide.ini` within the container (see `liteite-example.ini`)\n\nExample:\n```\ndocker run --name liteide --rm \\\n\t-e CHUSR=$(id -u):$(id -g) \\\n\t-e DISPLAY=\"${DISPLAY}\" \\\n\t--mount type=bind,src=/tmp/.X11-unix,dst=/tmp/.X11-unix \\\n\t--mount type=bind,src=/etc/machine-id,dst=/etc/machine-id \\\n\t--mount \"type=bind,src=${PROJECTDIR:-.},dst=/go/src/github.com/example/project\" \\\n\tmgoltzsche/liteide:latest \\\n\t/go/src/github.com/example/project\n```\n\n\n### LiteIDE usage\n\nThis section explains how to manage LiteIDE's build configuration.  \n\nIn order to build the whole project independent of your currently\nopened file and with the root package's `BUILDFLAGS` you may want\nto lock the build path as follows:\n\n- Using the root package's context menu select `Build Path Configuration`\n- Configure the `BUILDFLAGS` variable if required\n- `Lock Build Path` to the top-level directory\n\nIf you want keep your configuration across IDE restarts or ship it with\nyour project you need to enter the LiteIDE Docker container and copy \n`/opt/liteide/home/.config/liteide/liteide.ini` to your project dir at\n`./.liteide.ini`.\n\n\n## License\n\n- This project (Docker build + script): Apache License 2.0\n- [LiteIDE](https://github.com/visualfc/liteide): GNU Lesser General Public License v2.1\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgoltzsche%2Fliteide-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmgoltzsche%2Fliteide-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmgoltzsche%2Fliteide-docker/lists"}