You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+40-21
Original file line number
Diff line number
Diff line change
@@ -1,42 +1,61 @@
1
1
# FlexForm - Lightweight Form Server
2
2
3
-
## Introduction
4
-
5
3
Welcome to FlexForm, a fully open-source, headless form server designed with simplicity, efficiency, and privacy in mind. Built to be easily installed on any budget-friendly hosting solution or free cloud tiers, FlexForm is the perfect choice for developers and businesses looking for a reliable and GDPR-compliant form management solution.
6
4
7
5
<imgsrc="./public/images/screen.png"width="100%">
8
6
9
-
##Features
7
+
# Features
10
8
11
9
-**Headless Architecture**: FlexForm is built as a headless server, offering flexibility and ease of integration with various frontend systems.
12
10
-**Robust Admin Panel**: Manage your forms with ease using our user-friendly admin panel, designed for efficient and intuitive form management.
13
11
-**Cost-Effective**: Designed to run smoothly on inexpensive hosting or free cloud services, reducing your operational costs.
14
12
-**GDPR Compliant**: We prioritize your data privacy. FlexForm ensures that all your data remains yours, complying fully with GDPR regulations.
15
13
-**Open Source**: Dive into the code, customize, and contribute! Our community-driven approach means FlexForm is continually evolving.
16
14
17
-
## License
15
+
# Requirements
16
+
### PHP Version
17
+
- PHP 8.2 or higher.
18
+
19
+
### PHP Extensions
20
+
- GD
21
+
- ZIP
22
+
- XML
23
+
24
+
### Supported Databases
25
+
- SQLite
26
+
- MySQL
27
+
- PostgreSQL
28
+
- MariaDB
29
+
- AuroraDB
30
+
31
+
# License
18
32
19
33
FlexForm is released under MIT, ensuring it remains free and open for use and modification.
20
34
21
-
## Getting Started
35
+
# Getting Started
36
+
37
+
-[Deploying on cloud hosting](#deploying-on-cloud-hosting)
38
+
-[Deploying on shared hosting](#deploying-on-shared-hosting)
39
+
-[Running locally with docker](#running-locally-with-docker)
40
+
-[Running locally without docker](#running-locally-with-php-server)
41
+
-[Deploy instructions](#deploy-instructions)
42
+
22
43
23
-
### How to run locally with docker
24
-
Checkout the repository jump to the folder and run the following commands:
44
+
##Running locally with docker
45
+
Use the latest [image from docker hub](https://hub.docker.com/r/flexform/flexform-server) to run it locally:
25
46
```bash
26
-
docker-compose up
47
+
docker run --name flexform -d -p 9000:9000 flexform/flexform-server:0.1
27
48
```
28
49
Run DB migrations from container
29
50
```bash
51
+
docker exec -it flexform bash
30
52
php bin/console doctrine:migrations:migrate
31
53
```
32
54
33
-
### How to run locally without docker
55
+
##Running locally with PHP server
34
56
Make sure you have PHP 8.2 and composer installed.
35
57
Checkout the repository jump to the folder.
36
58
Copy environment file and adjust it to your needs:
37
-
```bash
38
-
cp .env.dev .env
39
-
```
40
59
Install dependencies:
41
60
```bash
42
61
composer install
@@ -50,16 +69,14 @@ Run the server:
50
69
php -S localhost:8000 -t public
51
70
```
52
71
53
-
### How to install on shared hosting
54
-
Build the project on your local machine or download prebuild release from [here](https://flexform.nyc3.cdn.digitaloceanspaces.com/flexform-server-latest.zip).
72
+
##Deploying on shared hosting
73
+
Build the project on your local machine or [download prebuild release](https://flexform.nyc3.cdn.digitaloceanspaces.com/flexform-server-latest.zip).
55
74
Upload the files to your shared hosting.
75
+
Make sure you make "public" folder as your main folder.
56
76
57
-
Make sure you:
58
-
- Set the environment variable `APP_ENV` to `prod` in your `.env` file. See [.env.prod](.env.prod) for an example.
59
-
60
-
### Deploy on cloud hosting
77
+
## Deploying on cloud hosting
61
78
You can deploy FlexForm on any cloud hosting provider that supports PHP 8.2 or higher.
62
-
Also you can use our Dockerfile to deploy FlexForm on any cloud hosting provider that supports docker.
79
+
Also you can use [FlexForm Docker Image](https://hub.docker.com/r/flexform/flexform-server) to deploy FlexForm on any cloud hosting provider that supports docker.
63
80
64
81
Make sure you:
65
82
- Set the environment variable `APP_ENV` to `prod`
@@ -68,10 +85,12 @@ Make sure you:
68
85
69
86
You can see an example of environment variables in the [.env.prod](.env.prod) file.
70
87
71
-
### Deploy instructions
88
+
**Please make sure you made /app/var as persistent storage if you use SQLite. If you want to use other database please change DATABASE_URL env variable.**
89
+
90
+
## Deploy instructions
72
91
-[Installing FlexForm on DigitalOcean Apps](https://medium.com/@ashelestov/installing-flexform-on-digitalocean-apps-b3e5b1ba868a)
73
92
74
-
##Frontend components
93
+
# Frontend components
75
94
FlexForm is a headless form server. This means that you can use any frontend framework to build your forms.
76
95
We provide a set of frontend components that you can use to build your forms.
0 commit comments