Skip to main content
Bukkit and Spigot are classic Minecraft server platforms that introduced plugin support to the Minecraft server ecosystem. While historically important, they have largely been superseded by Paper.
The GetBukkit download provider no longer supports automated downloads. It is highly recommended to use Paper instead, which is actively maintained, fully compatible with Bukkit/Spigot plugins, and offers significantly better performance.

​
Overview

Bukkit/Spigot servers provide:
  • Plugin Support: Run Bukkit/Spigot plugins for customization
  • Legacy Compatibility: Support for older plugins and configurations
  • Established Ecosystem: Large library of plugins available

​
Why Choose Paper Instead?

Paper is a drop-in replacement that offers:
  • Active development and maintenance
  • Significant performance improvements
  • Full Bukkit/Spigot plugin compatibility
  • Quick bug fixes and updates
  • Better security
Unless you have a specific reason to use Bukkit/Spigot (such as legacy compatibility), use Paper instead.

​
Configuration

​
Spigot Server

services:
  minecraft:
    image: itzg/minecraft-server
    environment:
      EULA: "TRUE"
      TYPE: SPIGOT
      VERSION: "1.20.4"
    ports:
      - "25565:25565"
    volumes:
      - ./data:/data
    restart: unless-stopped

​
Bukkit Server

environment:
  TYPE: BUKKIT
  VERSION: "1.20.4"

​
Environment Variables

VariableDefaultDescription
TYPE-Set to BUKKIT or SPIGOT
VERSIONlatestMinecraft version
BUKKIT_DOWNLOAD_URL-Custom Bukkit download URL
SPIGOT_DOWNLOAD_URL-Custom Spigot download URL
FORCE_REDOWNLOADfalseForce re-download if JAR is corrupted
BUILD_FROM_SOURCEfalseBuild Spigot from source

​
Version Selection

Some VERSION values require exact naming. For example, “1.8” is not sufficient - you need the exact version like 1.8-R0.1-SNAPSHOT-latest. Check the Bukkit/Spigot download page for exact version strings.

​
Specific Version

environment:
  TYPE: SPIGOT
  VERSION: "1.8-R0.1-SNAPSHOT-latest"

​
Custom Download URLs

Since automated downloads are limited, you can host your own server JARs: 
environment:
  TYPE: SPIGOT
  SPIGOT_DOWNLOAD_URL: "https://your-server.com/spigot-1.20.4.jar"
For Bukkit: 
environment:
  TYPE: BUKKIT
  BUKKIT_DOWNLOAD_URL: "https://your-server.com/bukkit-1.20.4.jar"

​
Building from Source

You can build Spigot from source: 
environment:
  TYPE: SPIGOT
  VERSION: "1.20.4"
  BUILD_FROM_SOURCE: "true"
Building from source takes significantly longer during initial startup but ensures you have the latest build.

​
Plugin Management

Bukkit/Spigot plugins work the same way as Paper plugins:

​
Manual Installation

volumes:
  - ./data:/data
  - ./plugins:/data/plugins
Place plugin JAR files in ./plugins/.

​
Auto-Download with Spiget

environment:
  TYPE: SPIGOT
  SPIGET_RESOURCES: "1234,5678"

​
Dedicated Plugins Volume

volumes:
  - ./data:/data
  - ./plugins:/plugins

​
Legacy Alternatives

These are specialized Bukkit forks for very old Minecraft versions:

​
Canyon

Fork of CraftBukkit for Minecraft Beta 1.7.3: 
environment:
  TYPE: CANYON
  VERSION: "b1.7.3"
  DISABLE_HEALTHCHECK: "true"
  CANYON_BUILD: "26"  # Optional specific build
Only VERSION=b1.7.3 is supported. Health checks must be disabled as this version pre-dates the health check mechanism.

​
Poseidon

Another fork of CraftBukkit for Minecraft Beta 1.7.3: 
environment:
  TYPE: POSEIDON
  VERSION: "b1.7.3"
  DISABLE_HEALTHCHECK: "true"

​
Uberbukkit

Multi-version fork supporting Beta 1.0 - 1.7.3: 
environment:
  TYPE: UBERBUKKIT
  VERSION: "b1.7.3"  # Or b1.0 through b1.7.3
  DISABLE_HEALTHCHECK: "true"

​
Corrupted Server JAR

If the downloaded server JAR is corrupted: 
environment:
  FORCE_REDOWNLOAD: "true"
Remove FORCE_REDOWNLOAD or set to false after successful re-download.

​
Migration to Paper

Migrating from Bukkit/Spigot to Paper is straightforward:
1

Backup your server

docker stop minecraft
cp -r ./data ./data-backup
2

Update server type

Change your compose file:
environment:
  TYPE: PAPER  # Changed from BUKKIT or SPIGOT
  VERSION: "1.20.4"
3

Start server

docker-compose up -d
Paper will automatically convert your Bukkit/Spigot world.
4

Verify plugins

All Bukkit/Spigot plugins should work immediately. Check server logs for any issues.

​
Complete Example

docker-compose.yml
services:
  minecraft:
    image: itzg/minecraft-server
    container_name: minecraft-spigot
    
    environment:
      # Server Type
      EULA: "TRUE"
      TYPE: SPIGOT
      VERSION: "1.20.4"
      
      # Custom URL (if needed due to download restrictions)
      # SPIGOT_DOWNLOAD_URL: "https://your-server.com/spigot.jar"
      
      # Or build from source
      # BUILD_FROM_SOURCE: "true"
      
      # Server Settings
      MOTD: "A Spigot Server"
      DIFFICULTY: normal
      MAX_PLAYERS: 20
      VIEW_DISTANCE: 10
      
      # Performance
      MEMORY: 4G
      
      # Plugins
      SPIGET_RESOURCES: "1234,5678"
    
    ports:
      - "25565:25565"
    
    volumes:
      - ./data:/data
      - ./plugins:/data/plugins
    
    restart: unless-stopped

​
Troubleshooting

​
Download Issues

Problem: Cannot download Bukkit/Spigot automatically Solution: Use custom download URL or switch to Paper: 
environment:
  TYPE: PAPER  # Recommended
Or: 
environment:
  TYPE: SPIGOT
  SPIGOT_DOWNLOAD_URL: "https://your-url.com/spigot.jar"

​
Version String Issues

Problem: Invalid version string Solution: Use exact version format from Bukkit/Spigot downloads page: 
environment:
  VERSION: "1.8-R0.1-SNAPSHOT-latest"  # Not just "1.8"

​
Plugin Compatibility

Problem: Plugins not loading Solution:
  1. Verify plugin supports your Bukkit/Spigot version
  2. Check for plugin dependencies
  3. Review server logs for specific errors
  4. Consider migrating to Paper for better compatibility

​
Why Paper is Better

FeatureBukkit/SpigotPaper
Active Development❌ Limited✅ Very Active
PerformanceBaseline✅ Significantly Better
Plugin Compatibility✅ Yes✅ Yes (same plugins)
Bug FixesSlow✅ Fast
Automated Downloads❌ Restricted✅ Supported
Modern FeaturesLimited✅ Extensive
Community SupportDeclining✅ Strong

​
Recommendation

Unless you have a specific legacy requirement, use Paper instead of Bukkit/Spigot. Paper offers:
  • All the same plugin compatibility
  • Much better performance
  • Active development and support
  • Reliable automated downloads
  • Regular updates and bug fixes

​
Next Steps

Migrate to Paper

Upgrade to Paper for better performance

Plugin Management

Learn about installing plugins

Spiget Downloads

Auto-download plugins from SpigotMC

Server Configuration

Configure server properties

Build docs developers (and LLMs) love

Get started for freeTalk to us