{"id":15155421,"url":"https://github.com/helton/neovim","last_synced_at":"2026-01-04T05:47:23.229Z","repository":{"id":257530065,"uuid":"858461499","full_name":"helton/neovim","owner":"helton","description":"⌨️Container images for the most used Neovim distributions e quick starters","archived":false,"fork":false,"pushed_at":"2024-09-17T15:48:35.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-21T07:33:43.765Z","etag":null,"topics":["docker","ghcr","neovim","nvim","vim"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/helton.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":"2024-09-16T23:53:16.000Z","updated_at":"2024-09-17T15:48:38.000Z","dependencies_parsed_at":"2024-09-17T08:12:56.291Z","dependency_job_id":"bb75133b-b702-4240-9c5f-7c5a304fceff","html_url":"https://github.com/helton/neovim","commit_stats":null,"previous_names":["helton/neovim"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/helton/neovim","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helton%2Fneovim","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helton%2Fneovim/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helton%2Fneovim/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helton%2Fneovim/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/helton","download_url":"https://codeload.github.com/helton/neovim/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/helton%2Fneovim/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280787216,"owners_count":26391052,"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","status":"online","status_checked_at":"2025-10-24T02:00:06.418Z","response_time":73,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":["docker","ghcr","neovim","nvim","vim"],"created_at":"2024-09-26T18:21:33.208Z","updated_at":"2025-10-24T11:30:35.587Z","avatar_url":"https://github.com/helton.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Neovim Docker Images\n\n![Docker Image CI](https://github.com/helton/neovim/actions/workflows/build.yml/badge.svg)\n\nContainerized environments for popular Neovim distributions and quick starters. Ideal for constrained environments where a streamlined Neovim setup with essential plugins is required.\n\n## Features\n\n- **Multi-Platform Support**: Builds for both `linux/amd64` and `linux/arm64` architectures, ensuring compatibility with traditional x86 systems and ARM-based systems like Apple's M1/M2 chips.\n- **Pre-installed Tools**: Comes with essential tools such as `bat`, `curl`, `fd-find`, `fzf`, `git`, `neovim`, `ripgrep`, `wget`, `zoxide`, and `zsh`.\n- **Multiple Neovim Configurations**: Supports various Neovim configurations and quick starters like [kickstart.nvim](https://github.com/nvim-lua/kickstart.nvim), [LazyVim](https://github.com/LazyVim/LazyVim), [NVChad](https://github.com/NvChad/NVChad), and [AstroVim](https://github.com/AstroNvim/AstroNvim).\n- **Customizable**: Easily map your own configurations and keybindings via Docker volumes.\n\n## Support Details\n\n### Neovim\n\n- 0.10.1: Latest release.\n\n### Platforms\n\n- **Linux Architectures**:\n  - `linux/amd64`\n  - `linux/arm64`\n\n- **macOS**:\n  - Runs seamlessly on macOS (including Apple Silicon) through Docker Desktop's virtualization layer.\n\n### Supported Neovim Configurations\n\n- [kickstart.nvim](https://github.com/nvim-lua/kickstart.nvim)\n- [LazyVim](https://github.com/LazyVim/LazyVim)\n- [NVChad](https://github.com/NvChad/NVChad)\n- [AstroVim](https://github.com/AstroNvim/AstroNvim)\n\n### Base Images\n\n- **Alpine 3.20**: Latest release.\n\n### Pre-installed Tools\n\n- `bat`: A `cat` clone with syntax highlighting and Git integration.\n- `cmake`: C/C++ build tool.\n- `curl`: Tool to transfer data from or to a server.\n- `fd-find`: Simple, fast, and user-friendly alternative to `find`.\n- `fzf`: A general-purpose command-line fuzzy finder.\n- `git`: Version control system.\n- `jq`: A lightweight and flexible command-line JSON processor.\n- `ripgrep`: Line-oriented search tool that recursively searches directories.\n- `wget`: Non-interactive network downloader.\n- `zoxide`: A smarter `cd` command.\n- `zsh`: Z shell, an extended Bourne shell with many improvements.\n\n### Languages Tooling/Runtimes\n\n- **Python**: 3.12.6\n- **Golang**: 1.23.1\n- **Rust**: 1.81.0\n- **Node**: 20.17.0\n\n## Installation\n\n### Pulling the Docker Image\n\nYou can pull the pre-built Docker images from GitHub Container Registry.\n\n```shell\ndocker pull ghcr.io/helton/neovim:kickstart.nvim-alpine-3.20\n```\n\n## Usage\n\n### Running Neovim\n\nTo run Neovim using the Docker image:\n\n```shell\ndocker run --rm -it ghcr.io/helton/neovim:kickstart.nvim-alpine-3.20\n```\n\nOr, to open Neovim in a specific directory:\n\n```shell\ndocker run --rm -it -v $(pwd)/app:/app -w /app ghcr.io/helton/neovim:kickstart.nvim-alpine-3.20\n```\n\nExample commands:\n\n```shell\ndocker run --rm -it -v ${PWD}/app:/app -w /app ghcr.io/helton/neovim:kickstart.nvim-alpine-3.20\ndocker run --rm -it -v ${PWD}/app:/app -w /app ghcr.io/helton/neovim:lazyvim-alpine-3.20\ndocker run --rm -it -v ${PWD}/app:/app -w /app ghcr.io/helton/neovim:nvchad-alpine-3.20\ndocker run --rm -it -v ${PWD}/app:/app -w /app ghcr.io/helton/neovim:astronvim-alpine-3.20\n```\n\n## Customization\n\nYou can customize your Neovim setup by mapping your own configurations and keybindings. This can be done by mounting your local Neovim configuration directory into the Docker container.\n\n### Overriding Neovim Configuration\n\n```shell\ndocker run --rm -it \\\n  -v ${PWD}/app:/app \\\n  -v ${HOME}/.config/nvim:/root/.config/nvim \\\n  -w /app \\\n  ghcr.io/helton/neovim:kickstart.nvim-alpine-3.20\n```\n\n### Notes on Custom Plugins\n\nIf you add new plugins to your Neovim configuration, ensure that they can be downloaded within the Docker image. Alternatively, use the default plugins provided by the image if you're operating in a constrained environment with limited network access.\n\n## Development\n\n### Build\n\nTo build the Docker images locally, ensure you have Docker Buildx installed and configured.\n\nRun the build script:\n\n```shell\n./build.sh\n```\n\nThis script utilizes Docker Buildx to build multi-platform images (linux/amd64 and linux/arm64).\nThe images will be tagged with the arch as suffix, like `neovim-kickstart.nvim-alpine-3.20-amd64`\n\n### Run\n\nTo run built images locally, use commands like the following:\n\n```shell\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:kickstart.nvim-alpine-3.20-amd64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:kickstart.nvim-alpine-3.20-arm64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:lazyvim-alpine-3.20-amd64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:lazyvim-alpine-3.20-arm64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:nvchad-alpine-3.20-amd64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:nvchad-alpine-3.20-arm64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:astronvim-alpine-3.20-amd64\ndocker run --rm -it -v ${PWD}/app:/app -w /app neovim:astronvim-alpine-3.20-arm64\n```\n\n## Contributing\n\nContributions are welcome! Please fork the repository and submit a pull request with your enhancements.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelton%2Fneovim","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhelton%2Fneovim","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhelton%2Fneovim/lists"}