Protorip
---
site: protos.rip
page: index
---
                      __             _     
    ____  _________  / /_____  _____(_)___ 
   / __ \/ ___/ __ \/ __/ __ \/ ___/ / __ \
  / /_/ / /  / /_/ / /_/ /_/ / /  / / /_/ /
 / .___/_/   \____/\__/\____/_/  /_/ .___/ 
/_/                               /_/      

the drop-in protobuf registry for buf cli

## usage

consume

1. add dependencies in `buf.yaml`:
```yaml
version: v2
deps:
- protos.rip/googleapis/googleapis
- protos.rip/bufbuild/protovalidate
```
2. resolve lockfile and generate code:
```bash
buf dep update
buf generate
```

publish

1. point `buf.yaml` at your protos.rip module:
```yaml
version: v2
modules:
- path: proto
name: protos.rip/scope/module
```
2. sign in, create the module, and push:
```bash
buf registry login protos.rip # or in ci: echo $PROTORIP_TOKEN | buf registry login protos.rip --token-stdin
buf registry module create protos.rip/scope/module
buf push
```

migrate

1. replace `buf.build` module names in `buf.yaml`:
```yaml
version: v2
modules:
- path: proto
name: protos.rip/scope/module
deps:
- protos.rip/googleapis/googleapis
```
2. refresh `buf.lock` and push:
```bash
buf registry module create protos.rip/scope/module
buf dep update
buf push
```

note: transitive dependencies must also be migrated to protos.rip first.

for more, read the buf documentation and check compatibility.

## pricing

planpricemodulesusers
free$0unlimited public, 1 private1
solo$9/mo ($7/mo yearly)unlimited public & private1
team$29/mo ($24/mo yearly)unlimited public & privateunlimited

free for [open source projects](/oss) (unlimited public modules, unlimited users).

[get started for free →](/dashboard)