mirror of
https://github.com/javi11/altmount.git
synced 2025-12-24 01:39:35 -08:00
usenet virtual fs
The unbounded bufpipe.New(nil) was causing memory to grow indefinitely as segment data was downloaded ahead of what was being read. When readers were slow or disconnected, the buffers accumulated in memory with no backpressure mechanism. Replace bufpipe with Go's standard io.Pipe() which provides natural backpressure - writers block when readers aren't consuming data, preventing unbounded memory growth. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com> |
||
|---|---|---|
| .github | ||
| cmd/altmount | ||
| config | ||
| docker | ||
| docs | ||
| frontend | ||
| internal | ||
| pkg/rclonecli | ||
| .dockerignore | ||
| .DS_Store | ||
| .gitignore | ||
| .golangci.yml | ||
| CLAUDE.md | ||
| config.sample.yaml | ||
| docker-compose-dev.yml | ||
| docker-compose.volume-plugin.example | ||
| docker-compose.yml | ||
| go.mod | ||
| go.sum | ||
| LICENSE | ||
| Makefile | ||
| README.md | ||
AltMount
A WebDAV server backed by NZB/Usenet that provides seamless access to Usenet content through standard WebDAV protocols.
📖 Documentation
Complete setup guides, configuration options, API reference, and troubleshooting information.
Quick Start
Docker (Recommended)
services:
altmount:
extra_hosts:
- "host.docker.internal:host-gateway" # Optional if you rclone is outside the container
image: ghcr.io/javi11/altmount:latest
container_name: altmount
environment:
- PUID=1000
- PGID=1000
- PORT=8080
- COOKIE_DOMAIN=localhost # Must match the domain/IP where web interface is accessed
volumes:
- ./config:/config
- /mnt:/mnt:rshared
- /metadata:/metadata # This is optional you can still use /mnt
ports:
- "8080:8080"
restart: unless-stopped
devices:
- /dev/fuse:/dev/fuse:rwm
cap_add:
- SYS_ADMIN
security_opt:
- apparmor:unconfined
CLI Installation
go install github.com/javi11/altmount@latest
altmount serve --config config.yaml
Links
- 📚 Documentation
- 🐛 Issues
- 💬 Discussions
Contributing
See the Development Guide. Development/setup for information on setting up a development environment and contributing to the project.
License
This project is licensed under the terms specified in the LICENSE file.
