juicedata/juicefs · error

not supported

Error message

not supported

What it means

Returned by the `juicefs gateway` command when the binary was compiled with the nogateway build tag. The command is registered as a stub that always fails; the S3 gateway feature is simply not present in this build.

Source

Thrown at cmd/gateway_noop.go:34

 * See the License for the specific language governing permissions and
 * limitations under the License.
 */
package cmd

import (
	"errors"

	"github.com/urfave/cli/v2"
)

func cmdGateway() *cli.Command {
	return &cli.Command{
		Name:        "gateway",
		Category:    "SERVICE",
		Usage:       "Start an S3-compatible gateway (not included)",
		Description: `This feature is not included. If you want it, recompile juicefs without "nogateway" flag`,
		Action: func(*cli.Context) error {
			return errors.New("not supported")
		},
	}
}

View on GitHub (pinned to c9a67b23e8)

Solutions

1. Recompile juicefs without the nogateway tag (use a standard or full build)
2. Install a full juicefs release binary that includes the gateway

When it happens

Trigger: Thrown at cmd/gateway_noop.go:34 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of juicedata/juicefs@c9a67b23e8 (2026-09-06). Data as JSON: /api/errors/622a0742d1574575. Report an issue: GitHub.