go-admin README

The project's README from github.com/go-admin-team/go-admin. As one markdown file: README.md.

go-admin

Build Status Release License

English | 简体中文 | 繁體中文 | 日本語

The front-end and back-end separation authority management system based on Gin + Vue + Element UI OR Arco Design OR Ant Design is extremely simple to initialize the system. You only need to modify the database connection in the configuration file. The system supports multi-instruction operations. Migration instructions can make it easier to initialize database information. Service instructions It's easy to start the api service.

documentation

Front-end project

Video tutorial

🎬 Online Demo

Element Plus vue3 demo：https://vue.go-admin.pro

Account / Password: admin / 123456

antd demo (go-admin-pro)：https://antd.go-admin.pro

Account / Password: admin / 123456

✨ Feature

🎁 Internal

  1. User management: The user is the system operator, this function mainly completes the system user configuration.
  2. Department management: configure the system organization (company, department, group), and display the tree structure to support data permissions.
  3. Position management: configure the positions of system users.
  4. Menu management: configure the system menu, operation authority, button authority identification, interface authority, etc.
  5. Role management: Role menu permission assignment and role setting are divided into data scope permissions by organization.
  6. Dictionary management: Maintain some relatively fixed data frequently used in the system.
  7. Parameter management: dynamically configure common parameters for the system.
  8. Operation log: system normal operation log record and query; system abnormal information log record and query.
  9. Login log: The system login log record query contains login exceptions.
  10. Interface documentation: Automatically generate related api interface documents according to the business code.
  11. Code generation: According to the data table structure, generate the corresponding addition, deletion, modification, and check corresponding business, and the whole process of visual operation, so that the basic business can be implemented with zero code.
  12. Form construction: Customize the page style, drag and drop to realize the page layout.
  13. Service monitoring: View the basic information of some servers.
  14. Content management: demo function, including classification management and content management. You can refer to the easy to use quick start.

Ready to work

You need to install locally [go] [gin] node 和 git

At the same time, a series of tutorials including videos and documents are provided. How to complete the downloading to the proficient use, it is strongly recommended that you read these tutorials before you practice this project! ! !

Easily implement go-admin to write the first application-documentation tutorial

Step 1 - basic content introduction

Step 2 - Practical application - writing database operations

Teach you from getting started to giving up-video tutorial

How to start go-admin

Easily implement business using build tools

v1.1.0 version code generation tool-free your hands [Advanced]

Explanation of multi-command startup mode and IDE configuration

Configuration instructions for go-admin menu [Must see]

How to configure menu information and interface information [Must see]

go-admin permission configuration instructions [Must see]

Instructions for use of go-admin data permissions [Must see]

If you have any questions, please read the above-mentioned usage documents and articles first. If you are not satisfied, welcome to issue and pr. Video tutorials and documents are being updated continuously.

📦 Local development

Environmental requirements

go 1.26.5

nodejs: v22+ (v24 LTS recommended)

package manager: pnpm v9+ (the UI project uses pnpm)

Development directory creation


# Create a development directory
mkdir goadmin
cd goadmin

Get the code

Important note: the two projects must be placed in the same folder;

# Get backend code
git clone https://github.com/go-admin-team/go-admin.git

# Get the front-end code
git clone https://github.com/go-admin-team/go-admin-ui.git

Startup instructions

Server startup instructions

# Enter the go-admin backend project
cd ./go-admin

# Update dependencies
go mod tidy

# Compile the project
go build

# Change setting 
# File path go-admin/config/settings.yml
vi ./config/settings.yml

# 1. Modify the database information in the configuration file
# Note: The corresponding configuration data under settings.database
# 2. Confirm the log path

⚠️ Note that this problem will occur if CGO is not installed in the windows10+ environment;

E:\go-admin>go build
# github.com/mattn/go-sqlite3
cgo: exec /missing-cc: exec: "/missing-cc": file does not exist

or

D:\Code\go-admin>go build
# github.com/mattn/go-sqlite3
cgo: exec gcc: exec: "gcc": executable file not found in %PATH%

Solve the cgo problem and enter

Initialize the database, and start the service

# The first configuration needs to initialize the database resource information
# Use under macOS or linux
$ ./go-admin migrate -c config/settings.dev.yml

# ⚠️Note: Use under windows
$ go-admin.exe migrate -c config/settings.dev.yml

# Start the project, you can also use the IDE for debugging
# Use under macOS or linux
$ ./go-admin server -c config/settings.yml

# ⚠️Note: Use under windows
$ go-admin.exe server -c config/settings.yml

Use docker to compile and start

# Compile the image
docker build -t go-admin .


# Start the container, the first go-admin is the container name, and the second go-admin is the image name
# -v Mapping configuration file Local path: container path
docker run --name go-admin -p 8000:8000 -v /config/settings.yml:/config/settings.yml -d go-admin-server

Generation Document

go generate

Cross compile

# windows
env GOOS=windows GOARCH=amd64 go build main.go

# or
# linux
env GOOS=linux GOARCH=amd64 go build main.go

UI interactive terminal startup instructions

# Install pnpm if you don't have it
npm install -g pnpm

# Installation dependencies
pnpm install

# Start service
pnpm dev

📨 Interactive

wenjianzhang
Wechat Wechat公众号🔥🔥🔥 go-admin技术交流乙号 bilibili🔥🔥🔥

💎 Contributors

JetBrains open source certificate support

The go-admin project has always been developed in the GoLand integrated development environment under JetBrains, based on the free JetBrains Open Source license(s) genuine free license. I would like to express my gratitude.

🤝 Thanks

  1. ant-design
  2. ant-design-pro
  3. arco-design
  4. arco-design-pro
  5. gin
  6. casbin
  7. spf13/viper
  8. gorm
  9. gin-swagger
  10. golang-jwt
  11. vue-element-admin
  12. ruoyi-vue
  13. form-generator

🤟 Sponsor Us

If you think this project helped you, you can buy a glass of juice for the author to show encouragement :tropical_drink:

🔑 License

MIT

Copyright (c) 2026 wenjianzhang

go-admin (go-admin-team/go-admin)

Searching Database…

12.8K ·GitHub
Go-admin
What is this?go-admin is a full-stack scaffold for building admin/back-office management systems: a Gin-based Go REST API paired with a Vue frontend (Element UI, Arco Design, or Ant Design). It comes with RBAC permission control, multi-tenant support, JWT auth, a code generator, and a drag-and-drop form builder so you can bootstrap a management panel quickly.
Do I get one app, or do I need to run the Go backend and Vue frontend separately?They are two separate projects (a Go server and a Vue UI) that you clone side by side and run independently; the README explicitly notes the two projects must be placed in the same folder.
How do I get it running locally?Clone the server and UI repos into the same folder, initialize the database and start the Go service, then start the Vue UI dev terminal separately. A Docker-based compile-and-start path is also provided.
What do I need installed before I start?You need Go, Gin, Node.js and git locally; the documented versions are Go 1.26.5, Node v22+ (v24 LTS recommended) and the pnpm v9+ package manager for the UI project.
Any known install snags?On Windows 10+ you'll hit a CGO-related build error unless CGO is set up correctly first; the README flags this explicitly as a known gotcha.
Where does this run?The Go server runs on Linux/Windows/macOS and can be containerized with Docker; the Vue UI is a browser-based web app.
What's included out of the box?User, department, position, menu, role and dictionary management, operation/login logs, parameter config, API docs, a code generator, a drag-and-drop form builder, and basic server monitoring.
How is access control implemented?Role-based access control (RBAC) is built on Casbin, with JWT used for authentication and menu/button/interface-level permission assignment per role.
Why are there three different UI themes (Element, Arco, Ant Design)?go-admin ships separate frontend variants built on Ant Design Pro, Arco Design Pro and Element UI so you can pick the design system that fits your project; a live Antd PRO demo is linked in the README.
Does it support multiple tenants?Yes, multi-tenant support is one of the core listed features alongside RBAC resource control and the form builder.
What are similar projects?gin-vue-admin, vue-admin-better, eladmin, JeecgBoot, logto, ApeAdmin, casdoor, gptibo
Which topics is it in?form-builder, gin, restful, vue-admin, ant-design, authorization, admin, multi-tenant, vue3, jwt, admin-dashboard, rbac
Creator
go-admin-team
Size
18.6 MB
Stars
12.8K
Updated
CommitOct 08Releasev2.8.0Oct 08
Age
6y
Commits · 90 Days