Commit Graph

322 Commits

Author SHA1 Message Date
Thomas Eizinger
d01456f451 docs: remove outdated license notice (#9906)
This directory no longer exists.

Signed-off-by: Thomas Eizinger <thomas@eizinger.io>
2025-07-18 14:28:08 +00:00
Jamil
1e94afdb98 chore: move terraform/ to private repo (#9421)
Since we'll be adding ops playbooks and other things here, it makes
sense to separate infra from product source.

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
2025-06-05 19:24:06 +00:00
Jamil
1ec3db387e refactor: use script/bump-version.sh instead of Makefile (#7907)
There isn't a good reason why we're using a Makefile instead of regular
Bash script for bumping versions, so this PR fixes that for better
maintainability.

It also reduces then chances for merge conflicts when bumping version
because the versions are longer on adjacent lines.

Fixes: #7904
2025-01-28 23:47:05 +00:00
Jamil
4cab2b5296 docs: Add support link to main README.md
Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
2025-01-16 22:15:25 -08:00
Jamil
6f7f6a4f34 style: Enforce code style across all supported languages using Prettier (#7322)
This ensure that we run prettier across all supported filetypes to check
for any formatting / style inconsistencies. Previously, it was only run
for files in the website/ directory using a deprecated pre-commit
plugin.

The benefit to keeping this in our pre-commit config is that devs can
optionally run these checks locally with `pre-commit run --config
.github/pre-commit-config.yaml`.

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Co-authored-by: Thomas Eizinger <thomas@eizinger.io>
2024-11-13 00:19:15 +00:00
Thomas Eizinger
791516db60 docs: gather useful tools for working on / with Firezone (#6986)
I wasn't quite sure where else to document this but I figured it is
useful to collect these as some kind of wiki for other devs.
2024-10-09 16:53:50 +00:00
Reactor Scram
f2d8b0f7e3 docs(maintainers): suggest always keeping a draft entry open (#6790)
This reduces merge conflicts when 2 PRs both want to make the first
change to a draft entry

Signed-off-by: Reactor Scram <ReactorScram@users.noreply.github.com>
2024-09-25 16:06:36 +00:00
Reactor Scram
c901d76501 docs(contributing): corrections (#6760)
1. `asdf install` doesn't seem to list which plugins you need, so we
explain that
2. No longer recommending `brew` for installing `pre-commit` since all
systems should have `pip` from `asdf` by the time they reach this step
3. Explain how to install from `requirements.txt` since that is needed
for all the pre-commit stuff to run like prettier and codespell.

---------

Signed-off-by: Reactor Scram <ReactorScram@users.noreply.github.com>
2024-09-19 15:30:05 +00:00
Jamil
0c6cd4a804 fix(ci): Add http test server image specifiers to CI (#6208)
- Adds `http_test_server_image` to inputs so that it gets set properly
for CI (`debug`) and CD (`perf`)
- Updates `dev` -> `debug` in docker-compose.yml to fix pulls
- Fixes issue with seeds and relevant docs from #6205
2024-08-07 12:15:00 -07:00
Jamil
4f71f21679 docs: Clean up contributing guide by removing redundant sections (#6203)
Some of these seemed to be added without taking into account the broader
context of the guide.
2024-08-07 07:59:46 -07:00
Reactor Scram
23161ec840 chore(gui-client): release 1.1.8 (#6136)
Signed-off-by: Reactor Scram <ReactorScram@users.noreply.github.com>
2024-08-01 21:58:18 +00:00
Jamil
7c6567c969 Update README.md
Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
2024-07-30 22:42:38 -07:00
Jamil
6ae494904e docs: Update 'user guides' -> 'client apps' (#5940)
- This terminology / naming makes things more clear for most
admins/users.
- Fixes layout of /kb/client-apps to align better

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Co-authored-by: Not Applicable <ReactorScram@users.noreply.github.com>
2024-07-23 14:04:07 +00:00
Reactor Scram
32014eafbf docs(maintainers): fix (#5894)
Signed-off-by: Reactor Scram <ReactorScram@users.noreply.github.com>
2024-07-18 15:10:15 +00:00
Jamil
478229e605 docs: update release playbook (#5863)
Update MAINTAINERS.md with most recent release playbook.

```[tasklist]
### Tasks
- [x] Merge `publish_release.md` into `MAINTAINERS.md`
- [ ] Merge PR
```

---------

Co-authored-by: Not Applicable <ReactorScram@users.noreply.github.com>
2024-07-12 21:19:36 +00:00
Jamil
ffe4d5f950 docs: fix references to AWS and Azure example modules (#5829)
These are now published at
https://www.github.com/firezone/terraform-aws-gateway and
https://www.github.com/firezone/terraform-azurerm-gateway to match the
unclear docs for registry module naming...
2024-07-11 16:10:12 +00:00
Jamil
ae87abacff chore: move AWS firezone-gateway module to dedicated repo (#5816)
Why:

Managing the module from Terraform registry is simpler if our published
module is in its own repo.

See https://github.com/firezone/terraform-firezone-aws
2024-07-09 14:05:14 -07:00
Jamil
a14f07cf45 Update README.md
Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
2024-07-09 06:16:33 -07:00
Jamil
9ac9dedfb9 feat: Azure scalable Gateway module and docs (#5644)
Resolves #2603
2024-07-03 07:16:56 +00:00
Jamil
fc8d89ea73 docs: Add AWS NAT Gateway example (#5543)
- Adds the AWS equivalent of our GCP scalable NAT Gateway.
- Adds a new kb section `/kb/automate` that will contain various
automation / IaaC recipes going forward. It's better to have these
guides in the main docs with all the other info.

~~Will update the GCP example in another PR.~~

Portal helper docs in the gateway deploy page will come in another PR
after this is merged.
2024-06-27 21:05:38 -07:00
FTB_lag
efd0218383 chore: fix contributing docs and fix feature flags in docker compose (#5572) 2024-06-27 11:45:59 -07:00
Jamil
8feb708730 docs: add note for compose v2 (#5110)
fixes #4641

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Co-authored-by: Reactor Scram <ReactorScram@users.noreply.github.com>
2024-05-23 18:03:01 +00:00
Jamil
bdbc17bb45 docs: Remove too large overview gif (#4878)
This is too large and wasn't being displayed.
2024-05-02 17:58:06 +00:00
Jamil
9606dde1d8 docs: Update README with more 1.x details, add overview screencap (#4877)
https://firezonehq.slack.com/archives/C04HRQTFY0Z/p1714602181648409
2024-05-02 03:11:23 +00:00
Reactor Scram
5faf51f890 chore(docs): formalize the rule for logging sensitive info (#4663)
Closes #4662
2024-04-17 20:19:29 +00:00
Jamil
c8917a58c5 refactor: Discord -> Slack (#4616)
Fixes firezone/bizops#82
2024-04-15 22:05:29 +00:00
Reactor Scram
3a67eacfbe refactor(linux-client): replace client-tunnel with headless-client which is the same thing (#4516)
Unfortunately I had to keep `linux-client` to get the compatibility
tests to pass. #4578 aims to remove that package.

Please add to this list if you think of anything:

```[tasklist]
# Things that may break that CI/CD won't catch
- [ ] Github release artifacts
- [ ] Knowledge base 
- [ ] Docker images
- [ ] Docker containers
- [ ] Existing `linux-client` users
- [ ] Anything that downloads ghcr artifacts
- [ ] Nix (Not sure if it's built in CI. It had a merge conflict)
```

Refs #4515, and #3712, #3782

I think this is what Thomas and I agreed on in Slack / Github

---------

Signed-off-by: Reactor Scram <ReactorScram@users.noreply.github.com>
Co-authored-by: Thomas Eizinger <thomas@eizinger.io>
2024-04-10 22:01:55 +00:00
Jamil
17cf833d8e docs: Mention signup in README and clarify self-hosting (#4528) 2024-04-05 19:33:35 -07:00
Jamil
cd5cde6ce1 chore(repo): Fix whitespace in MAINTAINERS (#4311) 2024-03-25 13:01:50 -07:00
Jamil
d4ba178515 Update MAINTAINERS.md
Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
2024-03-25 10:35:53 -07:00
Andrew Dryga
09dbd70dc5 chore(infra): Use Regional Instance Group in the GCP NAT example (#4183)
This example will work once our latest gateway is pushed to GitHub
Container Registry, but to test it for now a few overrides can be added
to the `main.tf` to use our Google Artifact Registry and local module
instead:
```diff
module "gateways" {
--  source = "github.com/firezone/firezone/terraform/modules/google-cloud/apps/gateway-region-instance-group"
++  source = "../../../modules/google-cloud/apps/gateway-region-instance-group"
...
++  container_registry = "us-east1-docker.pkg.dev"
++  image_repo         = "firezone-prod/firezone"
++  image              = "gateway"
}
```

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Signed-off-by: Andrew Dryga <andrew@dryga.com>
Co-authored-by: Jamil <jamilbk@users.noreply.github.com>
2024-03-19 08:44:14 -06:00
Andrew Dryga
114696c0ba chore(infra): Split terraform files into folders and add domain to production app (#4172) 2024-03-16 11:54:06 -06:00
Jamil
81ef6ce7a1 feat(docs): Example Gateway terraform module for GCP (#4011)
Adds a working example of the simplest way to deploy Gateways to GCP
that is also mostly cloud platform agnostic.

I avoided using COS and Docker for this because:

- Systemd is already installed and supports IPv6 already
- Can be more easily adapted to other platforms where Docker may not be
available or trickier to setup (E.g. CentOS 7)
- COS is Google-specific

---------

Signed-off-by: Jamil <jamilbk@users.noreply.github.com>
Co-authored-by: Andrew Dryga <andrew@dryga.com>
2024-03-12 10:57:18 -07:00
Jamil
008d891c9e feat(website): March Product Update (#3886)
March newsletter
2024-03-02 10:03:27 -08:00
Jamil
afac720d0d refactor(docs): Update SECURITY.md to mention opening GitHub security advisories (#3787)
fixes #3786
2024-02-29 16:57:10 +00:00
Thomas Eizinger
8d652cb96c chore: add nix scripts (#3771)
Some recent changes to the Rust part of the codebase made it quite
difficult to locally build the project due to tauri's heavy dependencies
on WebKitGTK and other native libraries.

I tried working around this on my local (nix) machine and found it quite
difficult. The cleanest way here is to make use of what Nix calls
"devshells" which give you an environment specifically for hacking on
your project.

Unfortunately, these files need to be tracked in version control and
cannot be ignored (at least I've not found a way to do that). Given that
we already have a lot of clutter in our repository, I put them under
`scripts/nix`.

They are generally useful. I also added a `.envrc` file which
automatically launches the dev-shell. As a result, you have a shell
ready to go with all your dependencies as soon as you `cd` into our
repository (assuming you use `direnv` and it is hooked up with your
shell).

I didn't really want to have any of my local setup leak into the repo
because I think apart from me and @conectado, nobody is using nix, thus
I hope this minimal footprint is an okay compromise.
2024-02-27 23:56:46 +00:00
Thomas Eizinger
67aeb009e9 chore: move markdown files into docs/ directory (#3773)
Apart from the LICENSE, GitHub supports detecting all of these files
also within a `docs/` directory. This includes the README!
2024-02-27 01:12:57 +00:00
Jamil
69335153ce Remove docs.firezone.dev CNAME (#1418)
This corresponds to step (1) of #1417
2023-02-09 15:19:19 -08:00
Jamil
0303ea2811 Short guide on backup / restore (#1411)
Fixes #1270
2023-02-08 12:42:01 -08:00
Jamil
8e73b1b8bb Refactor docs for REST API and consistency (#1404)
Also will include the following:

- [x] Fixes #1281
- [x] Fixes #1218
2023-02-07 08:24:11 -08:00
Jamil
49d4040b60 Add version tag to migrate script (#1400)
* Add new `VERSION` to `docker_migrate.sh` script
* Add missing `SAML_KEYFILE_PATH` and `SAML_CERTFILE_PATH` env vars to
migrate script
* Add missing `PHOENIX_PORT` var
* Bump Elixir to 1.14.3
* Bump Erlang to 25.2.1
* Update docs to document new VERSION var in docker-compose.yml upgrade
mechanism

Fixes #1395
2023-02-01 19:38:55 -08:00
Jamil
dc58d9820f Remove Cockroach note (#1397)
Fixes #1394
2023-02-01 10:18:00 -08:00
Jamil
e4854902cd Revert to old Project API key (#1379)
Also update ping event timer to 1 day, with a 1 minute delay on boot.

Waiting on PostHog to confirm old API key is set.
2023-01-26 12:49:11 -08:00
Jamil
bc6abb55e5 Document auto-create users more clearly in SAML setup guides (#1364)
There's been some confusion lately over the change to disable
auto-create users by default, so this PR aims to document the choice a
little more clearly.

Refs #1362 #1117

Co-authored-by: Andrew Dryga <andrew@dryga.com>
2023-01-23 12:47:18 -06:00
Jamil
394008c008 Chore/update project api key (#1348)
Refs firezone/marketing#109
2023-01-19 19:46:01 -08:00
Jamil
30fe5650ed Update troubleshooting guide for clearing auth config in DB (#1338)
Refs #1313
2023-01-19 17:46:37 -08:00
Jamil
bff52590e1 Migrate DB before using for the first time (#1310) 2023-01-13 17:43:44 -08:00
Jamil
ec321c5619 Update default REST API docs path; Note on stdout api tokens (#1306) 2023-01-13 17:23:21 -06:00
Jamil
330cafbbe5 Boot minimal app for DB changes (#1305)
Adds a minimal supervision tree for making DB changes from the
`FzHttp.Release` module. This allows the `bin/create-or-reset-admin` and
`bin/create-api-token` commands to be with `docker compose exec` or
`docker compose run --rm` indiscriminately.

Starting the FzHttp.Repo directly is more involved it's not compiled
into the release as an OTP app.
2023-01-13 13:45:18 -08:00
Jamil
e2e1dd441b Fix docs link (#1303) 2023-01-13 12:22:52 -08:00